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(57) Abstract 



The present invention is directed to a method of maintaining a partially replicated database in such a way that updates made to a 
central database (1 1). or to another partially replicated database, are selectively propagated to the partially replicated database. Updates are 
propagated to a partially replicated database if the owner of the partially replicated database is deemed to have visibility to the data being 
updated. Visibility is determined by use of predetermined rules stored in a rules database. In one aspect of the invention, the stored rules 
are assessed against data content of various tables that make up a logical entity, known as a docking object (5), that is being updated. The 
stored rules are assessed against data content of a docking object that is not necessarily updated, but that is related to a docking object 
being updated. In another aspect, the visibility attributes of the related docking objects are recursively determined. 



FOR THE PURPOSES OF INFORMATION ONLY 



Codes used to identify States party to the PCT on the front pages of pamphlets publishing international applications under the PCT. 



AL 


Albania 


BS 


Spain 


LS 


Lesotho 


SI 


Slovenia 


AM 


Armenia 


Fl 


Finland 


LT 


Lithuania 


SK 


Slovakia 


AT 


Austria 


FR 


France 


LU 


Luxembourg 


SN 


Senegal 


AU 


Australia 


GA 


Gabon 


LV 


Latvia 


sz 


Swaziland 


AZ 


Azerbaijan 


GB 


United Kingdom 


MC 


Monaco 


TD 


Chad 


BA 


Bosnia and Herzegovina 


GE 


Georgia 


MD 


Republic of Moldova 


TG 


Togo 


BB 


Barbados 


GH 


Ghana 


MG 


Madagascar 


TJ 


Tajikistan 


BE 


Belgium 


GN 


Guinea 


MK 


Hie former Yugoslav 


TM 


Turkmenistan 


BF 


Burkina Paso 


GR 


Greece 




Republic of Macedonia 


TR 


Turkey 


BG 


Bulgaria 


HU 


Hungary 


ML 


Mali 


TT 


Trinidad and Tobago 


BJ 


Benin 


IE 


Ireland 


MN 


Mongolia 


UA 


Ukraine 


BR 


Brazil 


IL 


Israel 


MR 


Mauritania 


UG 


Uganda 


BY 


Belarus 


IS 


Iceland 


MW 


Malawi 


US 


United States of America 


CA 


Canada 


IT 


Italy 


MX 


Mexico 


uz 


Uzbekistan 


CF 


Central African Republic 


JP 


Japan 


NE 


Niger 


VN 


Viet Nam 


CG 


Congo 


KE 


Kenya 


NL 


Netherlands 


vu 


Yugoslavia 


CH 


Switzerland 


KG 


Kvrgyzsun 


NO 


Norway 


zw 


Zimbabwe 


a 


Cote d' [voire 


KP 


Democratic People's 


NZ 


New Zealand 






CM 


Cameroon 




Republic of Korea 


PL 


Poland 






CN 


China 


ICR 


Republic of Korea 


FT 


Portugal 






CU 


Cuba 


KZ 


Kazakstan 


RO 


Romania 






CZ 


Czech Republic 


LC 


Saint Lucia 


RU 


Russian Federation 






DE 


Germany 


LI 


Liechtenstein 


SD 


Sudan 






DK 


Denmark 


LK 


Sri Lanka 


SE 


Sweden 






EE 


Estonia 


LR 


Liberia 


SG 


Singapore 







WO 97/35265 



PCT/US97/04320 



METHOD OF MAINTAINING A NETWORK OF PARTIALLY 

REPLICATED DATABASE SYSTEM 

INTRODUCTION 

I. Technical Field 

This invention relates to a system and method for providing updates to a 
network of partially replicated relational database systems, and, more particularly, 
for providing a reduced number of updates transmitted among partially replicating 
nodes in such a system. 

II. Background 

Relational databases are a commonly-employed data structure for 
representing data in a business or other environment. A relational database 
represents data in the form of a collection of two-dimensional tables. Each table 
comprises a series of cells arranged in rows and columns. Typically, a row in a 
table represents a particular observation. A column represents either a data field 
or a pointer to a row in another table. 

For example, a database describing an organizational structure may have 
one table to describe each position in the organization, and another table to 
describe each employee in the organization. The employee table may include 
information specific to the employee, such as name, employee number, age, 
salary, etc. The position table may include information specific to the position, 
such as the position tide ("salesman", "vice president", etc.), a salary range, and 
the like. The tables may be related by, for example, providing in each row of the 
employee table a pointer to a particular row in the position table, coordinated so 
that, for each row in the employee table, there is a pointer to the particular row in 
the position table that describes that employee's position. A relational database 
management system (RDBMS) supports "joining" these tables in response to a 
query from a user, so that the user making a query about, for example, a 
particular employee, may be provided with a report of the selected employee, 
including not only the information in the employee table, but also the information 
in the related position table. 
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Relational databases may be much more complex than this example, with 
several tables and a multiplicity of relations among them. 

With the widespread use of inexpensive portable computers, it is 
advantageous to replicate a database onto a portable computer for reference at 
locations remote from the central computer. The replicated database may then be 
referenced by the user of the portable computer, without requiring reference to the 
main database, which may be maintained at a central location inconvenient to the 
user of the portable computer. However, there are a number of difficulties with 
the use of a replicated database. 

One disadvantage is that a full copy of the central database may require 
more data storage than is desired or economical. For example, a salesman 
working in the field may need to refer to the database for information regarding 
sales opportunities in his sales area, but have no need to refer to any information 
regarding sales opportunities outside of his area. One possible approach to reduce 
the amount of required data storage is to simply replicate only that portion of the 
database that is needed by the user. However, this approach does not recognize 
that the criteria to determine which portions of the data are required is likely to 
vary over time. For example, the salesman may have a new city added to his 
territory. Under conventional approaches, the salesman would need to re-replicate 
his local copy of the database, this time selecting data including the added city. 
Such a practice is inconvenient, subject to error, and time-consuming. 

A further disadvantage to a replicated database is the difficulties 
encountered in attempting to update data using the replicated copy. A change 
made to the replicated database is not made to the central database, leading to a 
discrepancy between the information that is stored in the replicated copy of the 
database and the information that is stored in the central database. Although it is 
possible to journal modifications made to the replicated copy and apply an 
identical modification to the central database, one problem that this approach faces 
is the possibility of colliding updates; that is, where a user of a replicated copy 
makes a change to data that is also changed by a user of the central copy of by the 
user of another replicated copy. 

It is therefore desirable to provide a capability to maintain one or more 
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partially-replicated copies of a central database, in such a way that the degree of 
replication may be easily changed without requiring a refresh of the entire 
replicated database, and that permits updates to be coordinated among users of the 
central database and users of the partially replicated databases. 



SUMMARY OF THE INVENTION 

The present invention is directed to a method of maintaining a partially 
replicated database in such a way that updates made to a central database, or to 
another partially replicated database, are selectively propagated to the partially 
replicated database. Updates are propagated to a partially replicated database if 
the owner of the partially replicated database is deemed to have visibility to the 
data being updated. Visibility is determined by use of predetermined rules stored 
in a rules database. In one aspect of the invention, the stored rules are assessed 
against data content of various tables that make up a logical entity, known as a 
docking object, that is being updated. 

In another aspect of the invention, the stored rules are assessed against data 
content of one or more docking objects that are not necessarily updated, but that 
are related to a docking object being updated. In one embodiment, the visibility 
attributes of the related docking objects are recursively determined. 

In yet another aspect of the invention, changes in visibility are determined 
to enable the central computer to direct the nodes to insert the docking object into 
its partially replicated database. Such changes in visibility are determined so as to 
enable the central computer to direct a node to remove a docking object from its 
partially replicated database. 

In a further aspect of the invention, the predetermined rules are in 
declarative form and specify visibility of data based upon structure of the data 
without reference to data content. 



BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 depicts an overview of the operation of one embodiment of the 
present invention. 

Figure 2 depicts a database schema that shows the relationship of the 
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various components that make up a Docking Object. 

Figure 3 depicts steps performed by an update manager to update a 
database. 

Figure 4 depicts steps performed by a Docking Manager to transmit and/or 
receive one or more transaction logs. 

Figure 5 depicts the steps performed by a merge processor to merge 
transaction log records into an existing database. 

Figure 6 depicts the steps performed by a log manager to prepare a partial 
transaction log. 

Figure 7 depicts the steps performed by a visibility calculator for 
calculating visibility for a docking object as invoked by a log manager. 

Figure 8 depicts the steps performed to synchronize a partially replicated 
database in response to a change in data visibility. 

DESCRIPTION OF SPECIFIC EMBODIMENTS 

Figure 1 depicts an overview of the operation of one embodiment of the 
present invention. Figure 1 depicts a central computer system 1 and three remote 
computer systems (or "nodes") 21-a, 21-b, and 21-c. Each of nodes 21-a, 21-b 
and 21 -c are depicted in various states of communication with central computer 
system 1, as will be more fully explained. Central computer system 1 includes a 
central database 3, a docking manager 5, a merge processor 7 and a log manager 
9. Central computer system 1 additionally optionally includes update manager 11 
responsive to user input 13. 

Node 21-a is a remote computer system, such as a mobile client such as a 
laptop computer. Node 21-a includes a partially replicated remote database 23-a, 
update manager 31-a responsive to user input 33-a, docking manager 25-a and 
merge manager 27-a. In operation, update manager is responsive to user input 33- 
a to make changes to remote database 23-a as directed by the operator of node 21- 
a. Updates made are recorded, or journaled, in node update log 35-a. 

At some point at the convenience of the operator of node 21-a, node 
docking manager 35-a is activated, and enters into communication with central 
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docking manager 5. Update log 35-a is taken as input by node docking manager 
25-a, and provided to central docking manager 5. Central docking manager 5 
creates a received node update log 19, which contains all the information that had 
been recorded in update log 35-a. Optionally, partial log 17-a is taken as input by 
5 central docking manager 5 and provided to node docking manager 25-a, as more 

fully described herein. 

At some point in time, at the convenience of the operator of central 
computer system 1, merge processor 7 is activated. Merge processor 7 takes as 
input received node update log 19, and applies the updates described therein to 

10 central database 3. In the process of applying the updates from received node 

update log 19, merge processor journals the updates applied to central update log 
15. Optionally, update manager 11, responsive to user input 12 makes additional 
changed to central database 3 as directed by the operator of central computer 
system 1 . The updates made by update manager 1 1 are additionally journaled in 

15 central update log 15. 

At some point in time, at the convenience of the operator of central 
computer system 1, log manager 9 is activated. Log manager 9 takes as input 
central update log 15 and produces as output a set of partial logs 17-a, 17-b and 
17-c according to visibility rules as will be further described herein. Each of 

20 partial logs 17-a, 17-b and 17-c corresponds to one of nodes 21-a, 21-b and 21-c. 

When a node docking manager such as node docking manager 25-a enters into 
communication with central docking manager 5 and optionally requests 
transmission of its corresponding partial log, central docking manager 5 takes as 
input the appropriate partial log, such as partial log 17-a, and presents it to node 

25 docking manager 25-a. Node docking manager 25-a then replicates partial log 17- 

a as merge log 37-a. 

At some point in the future, at the convenience of the operator of node 21- 
a, merge processor 27-a is activated. Merge processor 27-a takes as input merge 
log 37-a, and applies the updates described therein to partially replicated database 

30 23-a. 

In addition to node 21-a, Figure 1 also depicts two additional nodes 21-b 
and 21-c. Node 21-b is depicted in communication with central computer 1. 
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However, unlike node 21-a, the operator of node 21-b has requested only to send 
his updates to central computer system 1 , and has not requested to be presented 
with changes made elsewhere to be made to his partially replicated database 23-b. 
This may be, for example, if the operator has an urgent update that must be made 
as soon as possible, but does not have the time to receive updates from other 
nodes. Accordingly, Figure 1 shows only transmission of node update log 35-a 
from node docking manager 25-b to central docking manager 5, and no 
transmission from central docking manager 5 to node docking manager 25-b. 
Accordingly, the merge manager for node 21-b is not activated and is not shown. 

Likewise, node 21-c is depicted as not in communication with central 
computer system 1. Accordingly, the docking manager for node 21-c is not 
activated and is not shown. 

By the cycle described above, updates made by each of nodes 21-a, 21-b 
and 21-c are presented to central computer system 1, permitting central database 3 
to be updated accordingly. In addition, each of the updates made by each of the 
nodes 21-a, 21-b and 21-c, as well as updates made on central computer system 1, 
are routed back to each of nodes 21-a, 21-b, and 21-c, thereby keeping each of 
partial databases 23-a, 23-b and 23-c in synchronization with each other and with 
central database 3. 

Database Structure 

The synchronization of central database 3 with node databases 23-a, 23-b 
and 23-c is performed using a construct called a Docking Object. A Docking 
Object consists of Member Tables (including one Primary Table), Visibility Rules, 
Visibility Events, and related Docking Objects. 

A Member Table is a table of the relational database that makes up a 
docking object. When a docking object is propagated from central database 3 to 
one of node databases 23-a, 23-b or 23-c, the propagation takes the form of an 
insertion into each of the Member Tables associated with the particular docking 
object. Similarly, when a docking object is scheduled to be removed from a 
database, that removal consists of deleting records from the member tables 
associated with the docking object. For example, a docking object that represents 
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a sales opportunity may include tables that represent the opportunity itself (e.g., 
named "S_OPTY"), the product whose sale is represented by the opportunity 
(e.g., named "S_OPTY_PROD"), the contact for the opportunity (e.g., named 
"S_OPTY_CONTACT"), etc. Each of these tables is said to be a member table of 
the "Opportunity Docking Object. " 

A Primary Table is a Member Table that controls whether a particular 
instance of a Docking Object is visible to a particular node. The Primary Table 
has a Primary Row-ID value that is used to identify a row of the Primary Table 
being updated, deleted or inserted. For example, the "Opportunity Docking 
Object" may have as a primary table the table S_OPTY. The row-id of that table, 
i.e., S_OPTY.row_id, is the Primary Row-ID for the Opportunity Docking 
Object. 

A Visibility Rule is a criterion that determines whether a particular instance 
of a Docking Object is "visible" to a particular node 21. If a Docking Object is 
visible to a particular node, that node will receive updates for data in the Docking 
Object. Visibility Rules are of two types, depending on the field RULE_TYPE. 
A Visibility Rule with a RULETYPE of "R" is referred to as an SQL Rule. An 
SQL Rule includes a set of Structured Query Language (SQL) statements that is 
evaluated to determine if any data meeting the criteria specified in the SQL 
statements exists in the Docking Object. If so, the Docking Object is visible to 
the node. A Visibility Rule with a RULE TYPE of "O" is referred to as a 
Docking Object Rule. A Docking Object Rule specifies another Docking Object to 
be queried for visibility. If the specified Docking Object is visible, then the 
Docking Object pointing to it is also visible. 

A Related Docking Object is a Docking Object that is propagated or deleted 
when the Docking Object under consideration is propagated or deleted. For 
example, an Opportunity Docking Object may have related Docking Objects 
representing the sales contacts, the organizations, the products to be sold, and the 
activities needed to pursue the opportunity. When an Opportunity Docking Object 
is propagated from Central Database 3 to one of node databases 23, the related 
docking objects are also propagated. 

Figure 2 depicts a database schema that shows the relationship of the 
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various components that make up a Docking Object. The schema is a meta- 
database, in that it does not describe the data being accessed in the database. 
Rather, the schema is a separate database that defines the structure of the database 
being accessed. That is, it is a database comprising tables that describe the 
relationships and data contexts of another database. 

Each of the tables shown in Figure 2 is a table in a relational database, and 
as such is in row-column form. Many columns represent fields that are common 
to all the illustrated tables. Such fields include for example, a ROW ID to 
identify a particular row in the table, as well as fields to track the date and time 
that a row was created and last modified, and the identity of the user who created 
or modified the row. In addition, each table contains fields specific to that table, 
and which are described in detail below. 

Table SJX)BJ 61 describes the Docking Objects in an application. Table 
S_DOBJ 61 includes the fields OBJ_NAME and PRIM ARYJT ABLE JD . Field 
OBJ_NAME defines the name of the Docking Object being described. Field 
PRIMARYTABLEID is used to identify the primary table associated with this 
Docking Object. 

Table SDOBJ JNST 63 describes whether a particular instance of a 
Docking Object, described by table S DOBJ 61, is present on a particular node's 
database. Table S_DOBJ_INST 63 includes the fields NODEJD, DOBJJD and 
PR _TBL_ROW ID. Field NODEJD points to a particular node table 65. Field 
DOBJJD points to the Docking Object to which the Docking Object instance 
applies. Field PR TBL ROW ID is used to select a particular row in the Primary 
Table of the Docking Object. This value identifies the Docking Object instance. 

Table SJIELDOBJ 67 describes the related Docking Objects of a 
particular Docking Object, described by table SJDOBJ 61. Table S_REL_DOBJ 
67 includes the fields DOBJJD, RELJ>OBJJD, and SQLJST ATEMENT . Field 
DOBJJD identifies the Docking Object that owns a particular related Docking 
Object. Field RELDOBJID identifies the related Docking Object that is owned 
by the Docking Object identified by DOBJJD. Field SQLSTATEMENT is an 
SQL statement that may be executed to obtain the Primary ID value of the related 
Docking Object. 
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Table S DOBJ TBL 69 describes the member tables of a particular 
Docking Object, described by table S_DOBJ 61. Table S_DOBJ_TBL 69 includes 
the fields DOBJJD, TBLJD, and VIS_EVENT_FLG. Field DOBJ ID identifies 
the Docking Object that contains the member table described by the row. Field 
5 TBLJD identifies the particular table in the database that is the member table 

described by the row. Field VIS_EVENT_FLG is a Hag that indicates whether a 
change to this Docking Object can result in a visibility event. A value of T" 
indicates that a change can result in a visibility event; a value of "N" indicates that 
it cannot. 

10 Table S_DOBJ_VIS_RULE 71 contains the visibility rules associated with a 

particular Docking Object. S DOBJ VIS RULE 71 contains the fields DOBJJD, 
RULE_SEQUENCE, RULEJTPE, SQLSTATEMENT and CHECK J)OBJJD. 
Field DOBJJD identifies the Docking Object with which a particular visibility 
rule is associated. Field RULESEQUENCE is a sequence number that indicates 

15 the sequence, relative to other visibility rules in table SJ)OBJ_VIS_RULE 71, in 

which the particular visibility rule should be run. RULEJTPE specifies whether 
the particular visibility rule is of type W R, " indicating an SQL visibility rule or of 
type "O," indicating a Docking Object visibility rule. 

If RULEJTPE is equal to "R/ field CHECK_DOBJJD is not 

20 meaningful, and field SQL STATEMENT contains an SQL statement that is 

evaluated using the Primary ROW-ID of the primary table associated with this 
Docking Object and a particular Node 21. If the SQL statement returns any 
records, the Docking Object is deemed to be visible to the Node 21 for which 
visibility is being determined. 

25 If RULEJTPE is equal to "O," both field CHECK_DOBJJD and field 

SQL STATEMENT are meaningful. Field CHECK J)OBJJD specifies a docking 
object whose visibility should be determined. If the specified docking object is 
deemed to be visible, then the docking object associated with the visibility rule is 
also visible. Field SQL_STATEMENT contains a SQL statement that, when 

30 executed, returns the Row-ID of the docking object identified by 

CHECK DOBJ ID that corresponds to the docking object instance associated with 
the visibility rule. 
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Table S_APP_TBL 73 is an Application Table that describes all the tables 
used in a particular application. It is pointed to by table S_DOBJJTBL 69 for 
each member table in a docking object, and by table S_DOBJ for the primary table 
in a docking object. S APP TBL 73 points to table S_APP_COL 75 , which is an 
Application Column Table that describes the columns of data in a particular 
application. S_APP_TBL 73 points to table S_APP_COL 75 directly through a 
primary key and indirectly through such means as a Foreign Key Column Table 
81, User Key Column Table 83, and Column Group Table 85. The relationship of 
an Application Table, Application Column Table, Foreign Key Column Table, 
User Key Column Table and Column Group Table are well known in the art and 
are not further described. 

Update Processing 

Figure 3 depicts steps performed by an update manager 31 such as update 
manager 31-a, 31-b or 31-c in updating a database, such as a node database 23-a, 
23-b or 23-c, responsive to user input. Execution of update manager 31 begins in 
step 101. In step 103, the update manager 31 accepts from the user input 33 in 
the form of a command requesting that the data in database 23 be altered. The 
request may be in the form of a request to delete a row of a table, to add a row to 
a table, or to change the value of a cell at a particular column of a particular row 
in a table. In step 105, using a well-known means, the update manager 31 applies 
the requested update to database 23. In step 107, the update manager 31 creates a 
log record describing the update and writes it to update log 35. 

The contents of a log record describe the update made. Each log record 
indicates the node identifier of the node making the update, an identification of the 
table being updated, and an identification of the type of update being made, i.e., 
an insertion of a new row, a deletion of an existing row, or an update to an 
existing row. For an insertion, the log record additionally includes an identifier of 
the row being inserted, including its primary key and the values of the other 
columns in the row. For a deletion, the log record identifies the primary key of 
the row being deleted. For an update, the log record identifies the primary key of 
the row being updated, the column within the row being updated, the old value of 
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the cell at the addressed row and column, and the new value of the cell. 

After writing a log record in step 107, the update processor exits for this 
update. The foregoing description of the update processing preferably includes 
additional steps not material to the present invention, for example, to assure 
authorization of the user to make the update, to stage and commit the write to the 
database to allow for rollback in the event of software or hardware failure, and the 
like. These steps are well-known in the art and are not described further. 

An update manager 1 1 executing in central computer system 1 operates in 
an analogous manner, except that it updates central database 3 and writes its log 
records to central update log 11. 

Docking Processing 

Figure 4 depicts steps performed by a Docking Manager 25 such as 
Docking Manager 25-a, 25-b or 25-c to transmit and/or receive one or more 
transaction logs. Docking Manager 25 is invoked by the user of a remote node 
such as node 21 -a, 21-b or 21-c, whereby the user requests that the node dock 
with central computer 1 to upload an update log such as update log 35-a to central 
computer 1, to download a partial log such as partial log 17-a, or both. Execution 
of Docking Manager 25 begins in step 121. In step 123, Docking Manager 25 
connects with central computer 1 under the control of Central Docking Manager 5. 
This connection can be any connection that enables data exchange. It is 
anticipated that the most common form of a connection is a telephone line used in 
conjunction with a modem, but other forms of data connection, such as a Local 
Area Network or a TCP/IP connection may also be used. Step 125 checks to see 
whether the user has requested that node update log 35-a be uploaded to the 
Central Computer 1. If so, execution proceeds to step 127. If not, step 127 is 
skipped and control is given to step 129. In step 127, Docking Manager 25 
uploads its update log to central computer 1. The upload may be accomplished 
with any known file transfer means, such as XMODEM, ZMODEM, KERMIT, 
FTP, ASCII transfer, or any other method of transmitting data. In step 25, 
Docking Manager 25 checks to see whether the user has requested that a partial 
log such as partial log 17-a be downloaded from Central Computer 1. If so, 
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execution proceeds to step 131. If not, step 131 is skipped and control is given to 
step 133. In step 131, Docking Manager 25 downloads its partial log from 
central computer 1 . The download may be accomplished with any known file 
transfer means, such as XMODEM, ZMODEM, KERMIT, FTP, ASCII transfer, 
5 or any other method of transmitting data. In step 133, having completed the 

requested data transfer, Docking Manager 25 exits. 

Merge processing is performed by a processor such as node merge 
processor 27-a, 27-b, or 27-c, or central merge processor 7. The merge process 

10 serves to update its associated database with a transaction that has been entered by 

a user of a computer remote from the computer where merge processing is being 
performed. Merge processing is analogous to update processing and is similar in 
form to update processing as previously disclosed with reference to figure 3, with 
three differences. First, the input to a merge processor is not an update entered 

15 directly by a user, but rather is a log file that is obtained from a computer remote 

from the computer where the merge is executing. A second difference is that, as 
shown by in Figure 1 , merge processing does not produce a log when performed 
at a node. The function of a log on a node is to record a transaction for 
propagation to Central Computer system 1 and thence to other nodes as required. 

20 A transaction that is the subject of a merge in a node has been communicated to 

Central Computer System 1, and there is no need to re-communicate it. 

A third difference is that merge processing must be capable of detecting 
and resolving multiple conflicting transactions. For example, assume that a field 
contains the value "Keith Palmer. " Assume further that a user at node 27-a enters 

25 a transaction to update that field to "Carl Lake/ and a user at node 27-b enters a 

transaction to update the same field to "Greg Emerson." Without collision 
detection, data among various nodes may become corrupt. When the transaction 
for user 27-a is merged, the field is updated from "Keith Palmer" to "Carl Lake." 
Without collision handling, when the transaction for node 27-b is merged, the field 

30 would be updated to "Greg Emerson, " and the central database would then be out 

of synch with the database of node 27-a. Furthermore, when merge processing is 
performed on each of nodes 27-a and 27-b, each node will update its database with 
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the other's transactions, leaving at least one node out of synch with the other node 
and with central database. 

Therefore, merge processing must also have a means of detecting collisions 
and correcting them. In the above example, a simple way to detect and correct a 
collision is to compare the value in the database to the value that the merge log 
reflects as being the previous value in the node database. If the two values do not 
match, Merge processor 7 may reject the transaction and generate a corrective 
transaction to be sent to the node from which the conflicting transaction 
originated. In the above example, when the transaction for node 27-b was 
presented to merge processor 7, merge processor 7 would compare "Keith 
Palmer," the prior value of the field as recorded by node 27-b to "Carl Lake," the 
present value of the field as recorded in central database 3 . Detecting the 
mismatch, merge processor 7 may then generate a transaction to change the value 
"Greg Emerson" to "Carl Lake," and write that transaction to update log 15. In a 
subsequent docking operation, that transaction would be routed back to node 27-b 
to bring its database 23-b in synch with the other databases. 

The above is one example of a collision and a resulting corrective action. 
Other types of collisions include, for example, an update to a row that has 
previously been deleted, inserting a row that has previously been inserted, and the 
like. Merge processing must detect and correct each of these collisions. This may 
be performed using any of a number of well-known methods, and is not discussed 
further. 

Figure 5 depicts the steps performed by merge processor such as central 
merge processor 7. Although it depicts merge processor 7 writing to central 
database 3 and to transaction log 15, it is equally representative of a node merge 
processor such as node merge processor 27-a, 27-b or 27-c updating a node 
database 23-a, 23-b or 23-c. Merge processing begins at step 141. In step 143, 
merge processor 7 finds the first unprocessed transaction on received log 19. In 
step 147, merge processor 7 selects a transaction from received log 19. In step 
149, merge processor 149 attempts to update database 3 acconling to the 
transaction selected in step 147. In step 151, merge processor 7 determines 
whether the database update of step 149 failed due to a collision. If so, merge 
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processor proceeds to step 153, which generates a corrective transaction. 
Following the generation of the corrective transaction, the merge processor returns 
to step 149 and again attempts to update database 3. If no collision was detected 
in step 151, execution proceeds to step 157. In step 157, merge processing checks 
to see if it is executing on central computer 1. If so, step 155 is executed to 
journal the transaction to log 15. In any case, either if step 157 determines that 
the merge processing is being performed on a node or after step 1 55 , execution 
proceeds to step 159. Step 159 checks to see if any transactions remain to be 
processed from log 19. If so, execution repeats from step 147, where the next 
transaction is selected. If not, merge processing exits in step 161. 

hQZ Management 

Figure 6 depicts the steps to be performed by log manager 9 to prepare a 
partial transaction log such as partial transaction log 17-a, 17-b, or 17-c. The 
procedure depicted in Figure 6 is executed for each node available to dock with 
central computer system 1. Log manager 9 begins execution in step 171. In step 
173, Log Manager 9 finds the first unprocessed transaction for the node whose 
partial transaction log is being prepared. In step 175, log manager 9 selects a 
transaction for processing. In step 177, log manager 9 checks to see whether the 
selected transaction originated on the same node for which processing is being 
performed. If so, there is no need to route the transaction back to the node, and 
control proceeds to step 179. Step 179 checks to see whether there are any 
transactions remaining to be processed. If so, control is given again to step 175. 
If not, control passes to step 189, which records the last transaction that was 
processed for this node, and then exits at step 191. If the transaction originates in 
other than the same node as the node for which processing is being performed, 
control is given to step 181. Step 181 calls a visibility calculator to determine 
whether the selected transaction is visible to the node being processed. The 
Visibility calculator routine is described in detail further herein. In step 183, 
merge processor 9 checks to see whether the visibility calculator determined that 
the transaction is visible. If it is not visible, control is passed to step 179, which 
performs as disclosed above. If the transaction is visible, control is passed to step 
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185. Step 185 writes a record for this transaction to the partial transaction log for 
the node being processed, for example, partial transaction log 17-a for node 21-a. 
In step 187, the log manager 9 records the last transaction that was processed for 
this node, and then passes control to step 179, which determines whether to select 
5 additional transactions or exit, as disclosed above. 

Visibility Calculation 

Figure 7 depicts a flowchart describing the process a visibility calculator 
for calculating visibility for a docking object as invoked by step 181 of log 

10 manager 9. The visibility calculator is called with the node-id of the node for 

which visibility is being calculated, the docking object for which the visibility is 
being calculated, and the row-id of the docking object whose visibility id being 
calculated. The visibility calculator uses this information, in conjunction with 
information obtained from meta-data stored in the schema depicted in Figure 2, to 

15 determine whether a particular transaction that updates a particular row of a 

particular docking object is visible to a particular node. 

The Visibility calculator begins execution at step 201. In step 203, the 
visibility calculator makes a default finding that the transaction is not visible. 
Therefore, unless the visibility calculator determines that a transaction is visible, it 

20 will exit with a finding of no visibility. In step 205, the visibility calculator 

selects the first visibility rule associated with the docking object. This is done by 
finding the table S DOBJ VIS RULE 71 associated with the current Docking 
Object as pointed to by table S_DOBJ 61. In step 205, the visibility calculator 
selects the row of table S DOBJ VIS RULE 71 with the lowest value for field 

25 RULESEQUENCE. 

In step 207, the Visibility Calculator checks the field RU1JETYPE for a 

value of "R." The value of W R M indicates that the rule is a SQL visibility rule. If 

so, the Visibility Calculator proceeds to step 209. In step 209 the Visibility 

Calculator obtains a SQL statement from field SQL STATEMENT and executes 
30 it. 
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An example of such an SQL statement might be: 

SELECT 'X' FROM S OPTY EMP 
WHERE OPTY ID Primary Rowld 
AND EMPJD = :NodeId; 

This SQL statement causes a query to be made of application table 
S_OPTY_EMP. The query selects any records meeting two criteria. First, the 
records selected must have a field OPTYJD, which is a row id or key, equal to 
the Primary Row-ID of the Docking Object whose visibility is being determined. 
Second, the records selected must have a field EMP_ID, which may be for 
example, an identifier of a particular employee, equal to the Nodeld of the node 
for whom visibility is being determined. In ordinary language, this SQL statement 
will return records only if a row is found in a table that matches employees to 
opportunities, where the opportunity is equal to the one being updated, and the 
employee to whom the opportunity is assigned is the operator of the node. 

This is a simplistic example, provided for maximum comprehension. More 

complex SQL statements are possible. For example, the rule: 

SELECT 'X' FROM 
&TableJ3wner.S_ACCTJPOSTN ap 
&Table O wner . S EMP POSTN ep 
WHERE ap.POSinONJD = ep.POSITION ID 
AND ep.EMPJD = :NodeId; 

This rule queries the tables S_ACCTJ>OSTN (which relates a particular 
account with a particular position in the organization that is responsible for the 
account) and S_EMP_POSTN (which relates what employee corresponds to a 
particular position). The condition "ap. POSITION JD = ep. POSITION JD° 
requires finding a row in the account-to-position table that has the same position as 
a row in the employee-to-position table. The condition "ep.EMPJD = :NodeId n 
further requires that the selected row in the employee-to-position table also have 
an Employee ID equal to the ID of the user of the Node for which visibility is 
being determined. In ordinary language, this condition allows visibility if the 
employee occupies the position that has responsibility for the account in the 
docking object being updated. 

There is no particular limit to the complexity of the conditions in the SQL 
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statement used to evaluate visibility. Particular implementations of SQL may 
impose limitations, and resource considerations may make it desirable to use less 
complex statements, but these limitations are not inherent in the invention. 

Step 21 1 evaluates whether the execution of SQL_STATEMENT in step 
209 returned any records. If records were returned, this indicates that the Node 
for which visibility is being checked has visibility to the docking object being 
processed. Accordingly, if records are returned, the Visibility Calculator proceeds 
to step 213. In step 213, the transaction is marked visible. Because no further 
rules need to be evaluated to determine visibility, the visibility calculator proceeds 
to step 228. Step 228 synchronizes the databases by determining whether the 
calculated visibility requires the insertion or deletion of a docking object into a 
particular node's partially replicated database. This may occur, for example, if a 
node is determined to have visibility to a docking object due to a change to a 
related docking object. For example, an owner of a node may be assigned to a 
particular activity that is related to a particular sales opportunity. As a result, the 
node should be provided with a copy of the object representing the sales 
opportunity. 

Figure 8 depicts the steps performed to synchronize a partially replicated 
database in response to a change in data visibility. Execution begins in step 241 . 
In step 243, the Visibility Calculator references the visibility just calculated for a 
docking object. If the Docking Object is visible, execution proceeds to step 245. 
Step 245 references the SJDOBJJNST table, to verify that a row exists for the 
Docking Object for the current node. If a row exists, this indicates that the node 
in question already has a copy of the referenced Docking Object, and the routine 
proceeds to step 255, where it exits. If, however, no row exists for the Docking 
Object at the node being processes, this indicates that the node in question does 
not have a copy of the Docking Object on its partially replicated database. The 
routine then proceeds to step 247, where a transaction is generated to direct the 
node to insert the Docking Object into its partially replicated database. 

If step 243 determines that the Docking Object is not visible, execution 
proceeds to step 249. Step 249 references the S_DOBJ_INST table, to verify that 
no row exists for the Docking Object for the current node. If step 243 determines 
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that no row exists in the S_DOBJ_INST table for the current docking object for 
the current row, this indicates that the node in question does not have a copy of 
the referenced Docking Object, and the routine proceeds to step 255, where it 
exits. If, however, a row exists for the Docking Object at the node being 

5 processed, this indicates that the node in question does have a copy of the Docking 

Object on its partially replicated database. The routine then proceeds to step 251, 
where a transaction is generated to direct the node to delete the Docking Object 
from its partially replicated database. 

Referring again to Figure 7, following the data synchronization routine of 

10 step 228, the Visibility Calculator proceeds to step 229, where it exits. Referring 

to Figure 6, as previously described, the resulting finding of visibility is available 
to be checked by the log manager in step 183 to determine to write the transaction. 

Referring again to figure 7, if step 211 determines that no records were 
returned by the execution of the SQL statement in step 209, execution proceeds 

15 with step 215. Step 215 checks to see whether there are any remaining visibility 

rules to be assessed. If not, the visibility calculator proceeds to step 228 to 
synchronize the database, and then to step 229, where it exits. In this case, the 
default mark of no visibility that was set in step 203 remains set. This value will 
also be used by the log manager as shown in Figure 6, step 183, to determine not 

20 to write the transaction. 

Referring again to Figure 7, if rules remain to be assessed, control 
proceeds to step 217, which selects the next rule to be processed. Control is then 
given again to step 207 to begin processing the new rule. 

The preceding text provided a description of the processing or SQL 

25 visibility rule; that is, visibility rules of type "R. tt If step 207 determines that the 

visibility rule is not of type "R," the visibility rule is of type "O." Type "O" 
indicates a docking-object visibility rule. In such a case, the docking object being 
processed will be considered to be visible if it is related to a particular related 
docking object that is visible. If field RULEJTYPE is not equal to W R, W then. 

30 execution proceeds to step 221. Step 221 determines the related Docking Object 

whose visibility must be determined to determine whether the current docking 
object is visible. The related Docking Object identifier is obtained from field 



WO 97/35265 PCT/US97/04320 

19. 

CHECK DOBJ^ID in table S_DOBJ_VIS_RULE 71. In step 223, the Visibility 
Calculator determines which row in the related Docking Object must be queried 
for visibility. In order to determine this, the Visibility Calculator obtains a 
predetermined SQL statement from the field SQLSTATEMENT and executes it. 
The SQL statement is a query that select one or more rows of the Docking Object 
that, for example, correspond to the docking object for which the Visibility 
Calculator was invoked. 

For example, assume that it is desired to indicate that a record for a sales 
opportunity should be visible if the Node has visibility to any sales quote made for 
that sales opportunity. This may be accomplished using the following SQL 
statement: 

SELECT " JD" FROM 

&fable Owner. SJDOC QUOTE 
WHERE OPTYJD=: Primary Rowld 

This SQL statement accesses a table SDOCQUOTE that contains all sales 
quotes. The WHERE clause specifies retrieval of all rows where the Opportunity 
ID of the row is equal to the Row-ID of the opportunity for which visibility is 
being calculated. The Visibility manager retrieves the specified Row-Ids, thereby 
identifying the rows of the S_DOC_QUOTE table whose visibility must checked. 

Having determined the a related docking object and the row-ID of that 
related docking object upon whose visibility the visibility of the current docking 
object depends, the Visibility Calculator proceeds to step 225. In step 225, the 
Visibility Calculator recursively invokes itself to determine visibility of the related 
docking object. The recursively invoked Visibility Calculator operates in the same 
manner as the Visibility Calculator as called from the Log Manager 9, including 
the capability to further recursively invoke itself. When the recursive call 
concludes, it returns a visibility indicator for the related Docking Object, and 
control proceeds to step 227. In step 227, the Visibility calculator determines 
whether the related Docking Object was determined to have been visible. If so, 
the Visibility Calculator proceeds to step 213 to mark the originally current 
Docking Object as visible, and then to step 228 to synchronize the database and 
then to step 229 to exit. If the related Docking Object was not determined to be 
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visible, control proceeds to step 21 5 to determine whether additional visibility 
rules remain to be assessed. 

The Visibility Calculator, in conjunction with the Log Manager is therefore 
able to determine what subset of update transaction data is required to be routed to 

5 any particular node. This operation serves to reduce the transmission of unneeded 

data from the Central Computer 1 to the various nodes such as nodes 21 -a, 21-b 
and 21-c that utilize partially replicated databases, and to reduce the system 
resources such as disk space needed to store, and the CPU time needed to process, 
what would otherwise be required to maintain a fully replicated database on each 

10 remote node. 

The operation of the log manager 9 in conjunction with the Visibility 
Calculator herein described will be apparent from reference to the description and 
to the drawings. However, as a further aid in the description of these facilities, a 
pseudocode representation of these facilities is hereto attached as an Appendix. 

15 

The previous description of the embodiments has been provided to enable 
any person skilled in the art to make or use the present invention. Various 
modifications to these embodiments will be readily apparent to those skilled in the 

20 art, and the generic principles defined herein may be applied to other embodiments 

without the use of inventive faculty. Thus, the present invention is not intended to 
be limited to the embodiments shown herein, but is to be accorded the widest 
scope consistent with the principles and novel features disclosed herein. 

All publications and patent applications mentioned in this specification are 

25 herein incorporated by reference to the same extent as if each individual 

publication or patent application was specifically and individually indicated to be 

incorporated by reference. 

The invention now being fully described, it will be apparent to one of 
ordinary skill in the art that many changes and modifications can be made thereto 
30 without departing from the spirit or scope of the appended claims. 
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APPENDIX 

Writing User Transaction Log File for a Given Laptop Node 

This program will be called by a server-side process that processes transaction log 
entries for all Laptop Nodes. For each Laptop Node, the calling process building the 
UserTrxnLogFileName and calling Program 1 . 



Input Parameters 

• LaptopNodeld - node_id of the destination laptop 

10 • UserTxnLogFileName - full path of the file where txns will be written 

• MaxBatchTxns - number of txns between commits and updates to the 
S_DOCK_STATUS table 

• MaxTxns - number of txns to process in this session. Use this parameter to 
limit processing. 

15 Main Algorithm 

Check parameters 
IF (MaxTxns < l j | MaxBatchTxns < 1) THEN 
_ Invalid Parameter 

20 END IF 

Get last LOG_EXTRACT number for the Laptop from S_DOCK STATUS 
last_txn_commit_number « UTLDStatGetLogNum (LaptopNodeld) 7 

25 Initialize Variables 

NumTxns = 0/ Total number of txns processed 

NumBatchTxns - 0; Total number of txns written in the current 

batch 

Read Docking Object and Table definitions into memory structures 
StartDictApi () ; 

Open the User Log Txn file 
Open User Log Txn file 

Select and process new txns in S_DOCK_TRANSACTION_LOG 
where txn_commit_number > last txn commit number 
FOR each new txn LOOP ~~ ~ ~ 

Stop processing if reach MaxTxns 
IF NumTxns = MaxTxns THEN 
break ; 

END IF; 



30 



35 



40 



45 7" Prevent circular txns. Do not send the txn back to the 

originating laptop 

IF txn.OriginNodeld = LaptopNodeld THEN 

Goto next transaction 
END IF; 



50 



55 



Process all other types of transactions 
This is the visibility calculator! 

This routine also processes implicit visibility events 

Later: Data Merge can call this function to check whether a txn 

is 
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still visible when merging txns into a laptop or server 
database . 

CheckVisibility (LaptopNodeld, LogRecordType, TableName, 
TransRowId) ; 

IF txn is visible THEN 

-- Write transactions to UserTxnLog file depending on the 

type of LogRecordType. 
Write the txn to the user log file 
++NumBatchTxns 
END IF; 

Finished processing the txn 
Commit (if needed) 
IF NumBatchTxns = MaxBatchTxns THEN 

Assume that separate process comes around and deletes 
-- Txns in S_DOCK_TRANS ACT 1 0N_LO0 that have been processed 

for all nodes. So, no need to delete the txns from the log. 
Update last LOG_EXTRACT number for Laptop in S_DOCK_STATUS 
Commit ; 

NumBatchTxns = 0 
END IF; 

++NumTxns 

End Loop; /* Each transaction in the Txn Log table */ 
-- Commit 

Update last LOG_EXTRACT number for Laptop in S_DOCK_STATUS 
Commit; 

Close log file (if needed) 
IF UserTxnLogFileP NULL THEN 

Close File; 
END IF; 

StopDictApi {) ; 



Check Visibility Routines 

Check if a record in the txn log is visible to a LaptopNodeld 
BOOL CheckVisibility (LaptopNodeld, LogRecordType, TableName, 
TransRowId) 

SQLStatements routed based on the destination list 
IF LogRecordType in ( 1 SQLStatement ' ) THEN 
IF Laptop Node in destination list THEN 

return TRUE; 
END IF; 

Shadow and Multi Record LogRecordType s are routed to all nodes 
--No visibility events with these LogRecordType s . 
ELS IF LogRecordType in { ' ShadowOperation' , 'MultiRecordDelete' , 

'MultiRecordUpdate' ) THEN 

return TRUE; 

-- Simple Deletes need more processing 

ELSIF LogRecordType in ('Simple Delete') THEN 

IF (table. visibility in ('Enterprise', 'Limited')) THEN 
return TRUE; 

END IF; 

-- Simple Inserts and Simple Updates need more processing 
-- CheckTxnVisibility () also processes implicit visibility events 
ELSIF LogRecordType in ('Simple Insert', 'Simple Update') THEN 
IF (table. visibility = 'Enterprise') THEN 
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return TRUE; 
ELS IF table. visibility = 'Limited' THEN 

IF CheckTxnVisibility (LaptopNodeld, Table, Rowld) THEN 

return TRUE; 
END IF; 
END IF; 
END IF; 

Check if a record in the txn log is visible to a LaptopNodeld 
static BOOL CheckTxnVisibility (LaptopNodeld, Table, Rowld) 

BOOL bVisible = FALSE; 

Find the Table in the Dictionary; 
IF Table not found THEN 

Error: Table not defined 
END IF; 

FOR all docking objects that the table belongs to LOOP 

Generate SQL to get Primaryld values of the Docking Object 
GeneratePrimaryldSQL (Table, Rowld, DockingObject) ; 
FOR each Primaryld value retrieved LOOP 

CheckObjectVisibility (LaptopNodeld, PrimaryTable, 
PrimaryRowId) 

IF object is visible THEN 

-- Because CheckObjectVisibility () also processes implicit 
visibility events, we must loop through ALL dockinq 
objects * 

-- even if we already know that the Txn is visible. 
Exception: if the table has VlS_event_FLG « 'N' 
then we can return immediately. 
IF Table. visibilityEventFLG = 'N' THEN 

return TRUE; 
ELSE 

bVisible = TRUE; 
END IF; 
END IF; 
END LOOP; 
END LOOP; 



return bVisible; 



Check if an instance of a docking object is visible to the laptop 
user. * * 

Also processes implicit visibility events* 
BOOL CheckObjectVisibility (LaptopNodeld, DockingObjectName, 
PrimaryRowId) 

FOR each visibility rule for the Docking Object LOOP 
IF RuleType *» Rule SQL THEN 

Run the select SQL statement using PrimaryRowId; 
IF any rows returned THEN 
row is visible 

Process an implicit Download Object 
DownloadObjectlnstance (LaptopNodeld, PrimaryTableName , 

PrimaryRowId) ; 

return TRUE; 

END IF; 

ELSIF RuleType » CheckDockingObject THEN 

Run the ParameterSQL using PrimaryRowId to get newPrimaryRowld 
FOR each record retrieved by ParameterSQL LOOP 
-- RECURSIVE J 

CheckObjectVisibility (LaptopNodeld, CheckDockingObjectName, 

newPrimaryRowld) ; 
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IF rc = TRUE THEN 

Process an implicit Download Object 
DownloadObject Instance (LaptopNodeld, PrimaryTableName , 

PrimaryRowId) ; 

return TRUE; 
END IF; 
END LOOP; 
END IF; 
END LOOP; 

Object is not visible. 

Process an implicit Remove Object 
RemoveObject Instance (LaptopNodeld, PrimaryTableName , 
PrimaryRowId) ; 

return FALSE; 

} 



Generate SQL Statement to Get Primaryld 

Generate the SELECT SQL statement to get the Primaryld value of 
the docking object for the given MemberTable 

SQL statement looks like: 
SELECT tp.<row_id> 

FROM <table_owner>. <Table> tl, 

<table_owner>.<PKTable> t2, 

... one or more intermediate tables between the table 

and the PrimaryTable 
<table_owner>. <PKTable> tN 
<table_owner>.<PrimaryTable> tp 
WHERE tl.ROW ID = :row_id /* row_id in transaction log */ 
/* join to PK table t2 */ 
AND tl .<FKColumn> = t2 . <PKColumn> 
AND <tl FKCondition> 

/* any number of joins until reach the table that joins 

to the PrimaryTable */ 
/* join from t2 to tN */ 
AND t2 . <FKColumn> » tN . <PKColumn> 
AND <t2 FKCondition> 
/* join to the PrimaryTable */ 
AND tN.<FKColumn> = tp. <PKColumn> 
AND <tN FKCondition> 

Note that there may be one or more paths from the Member Table 
--to the Primary Table. We need to generate a SQL select statement 
-- for each of the paths and UNION the statements together. 

-- This function assumes that there are no loops in the definition. 

-- These SQL statement do not change for each Table in a Docking 
Object, 

-- so we can calculate them one and store them in memory, 
struct 

{ 

CHAR* selectList; 
CHAR* fromClause; 
CHAR* whereClause; 

UINT numTables; /* also the number of joint to reach the Primary 
Table */ 
} GenStmt ; 
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GeneratePrimaryldSQL (Table, DockingObject) 

/* there may be more than one SQL statement, so we have a dynamic 
array of SQL statements. Bach element in the array is a path 
from the Table to the Primary Table*/ 

DynArrld GenStmtArr; 

GenStmt newGenStmt; 

CHAR* sqlStmt; 

DynArrCreate (GenStmtArr) ; 

Create the first element and initialize 
newGenStmt « mallocO; 
newGenStmt .numTables « 1; 
newGenStmt .selectList « "SELECT row_id" ; 
newGenStmt . fromClause = "FROM <Table> tl"; 
newGenStmt .whereClause = "WHERE tl.ROW ID o :row id"; 
DynArr Append (GenStmtArr, fcnewGenStmt) 7 " 

/* Recursively follow FKs to the PrimaryTable */ 

Build the select, from and where clause simultaneously */ 
AddPKTable (Table, DockingObject, GenStmtArr, 0) ; 

-- Union all the paths together 
numStmts o DynArrSize (GenStmtArr) ; 
FOR all elements in the array LOOP 

trapSqlStmt = GenStmtArr [j] . selectList | | GenStmtArr [j J . fromClause 
I I GenStmtArr [ j ] . whereClause ; 

sqlStmt = sqlStmt || 'UNION' || trapSqlStmt; 
END LOOP; 

DynArrDestroy (GenStmtArr) ; 

IF sqlStmt =» NULL THEN 

Error; no path from Table to Primary Table. 

END IF; 

} 



Recursively follow all FKs to the Primary Table 
AddPKTable (Table, DockingObject, GenStmt, InputStmtNum) 

UINT numFKS = 0; 
UINT StmtNum; 
GenStmt newGenStmt; 

FOR all FKs for the table LOOP 

IF PKTable is a Member Table of the Docking Object THEN 

If there's more than one FK, then there is more than one 



path 



-- out of the current table. 

-- Copy the SQL stmt to a new DynArrElmt to create a new path 
IF numFKs > 0 THEN 

Create a new element and copy from GenStmt [InputStmtNum] 
newGenStmt = mallocO; 

newGenStmt. numTables = GenStmt [InputStmtNum] .numTables ; 
newGenStmt. selectList = GenStmt [InputStmtNum] . selectList • 
newGenStmt . fromClause « GenStmt [InputStmtNum] . fromClause ' 
newGenStmt. whereClause «= GenStmt [InputStmtNum] .whereClause • 
DynArrAppend (GenStmtArr, fcnewGenStmt) ; 
StmtNum = DynArrSize (GenStmtArr) ; 

-- Put a check here for infinite loops 
IF StmtNum »- 20 THEN 

Error: Probably got an Infinite loop? 
END IF; 
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ELSE 

StmtNum o Input StmtNum; 
END IF; 

Append the new PKTable to the fromClause and whereClause 
GenStmt [StmtNum] . fromClause - 

QenStmt [StmtNum] .fromClause || M ,\n <Table> t<numTables + 

l> n ; 

GenStmt [StmtNum] .whereClause = 

GenStmt [StmtNum] .whereclause | j 
"AND t<numTables>. <FKColumn> » t<numTables + 
l>.<PKColumn>" | | 

"AND <FKCondition for Table if any>"; 
++GenStmt . numTables ; 

«- PKTable is the Primary Table then Done. 
IF PKTable - PrimaryTable THEN 

RETURN; 
ELSE 

AddPKTable (PKTable, DockingObject , GenStmt, StmtNum); 
END IF; 

Only count FKs to other member tables in the same Docking 

Ob j ect 

++numFKs; 

END IF; 
END LOOP; 

RETURN; 

} 

Process Visibility Events 



Download an Object Instance to a Laptop 

This function also downloads all Related Docking Object instances. 
BOOL DownloadObj ect Instance (LaptopNodeld, ObjectName, PrimaryRowId) 

' -- Check if the object instance is already downloaded to the laptop 
Find the object instance in the SJX>BJ_INST table 
IF exists on laptop THEN 

return TRUE; 
END IF; 

Register object instance in S_DOBJ_INST table 

-- Write Download Object records to the Txn Log 

FOR each member table of the docking object LOOP 
Generate SQL select statement to download records 
Write each retrieved record to the User Txn Log file 

END LOOP; 

Download records for Parent Object instances 
FOR each RelatedDockingObject LOOP 

Run ParameterSQL to get newPrimaryld of RelatedDockingObjects 
FOR each newPrimaryld retrieved LOOP 

-- Check if the instance of the object is visible to the laptop 

user 

CheckObjectVisibility (LaptopNodeld, ObjectName, PrimaryRowId) 

IF visible THEN 

DownloadObj ectlnstance (LaptopNodeld, 

Rela tedDockingOb j ect , 

newPrimaryRowId) ; 
END IF; 
END LOOP; 
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END LOOP; 
return TRUE; 



Remove an object Instance to a Laptop 

This function also removes all Related Docking Object instances 
BOOL Removeobjectlnstance (LaptopNodeld, ObjectName, PrimaryRowld) 

Check if the object instance is already downloaded to the lapt 
Find the object instance in the S_DOBJ INST table 
IF does not exist on laptop THEN 

return TRUE; 
END IF; 



Delete the object instance from S_DOBJ_INST table 

Write Remove Object records to the Txn Log 
FOR each member table of the docking object LOOP 

Generate SQL select statement to get records to delete 
Write each retrieved record to the User Txn Log file 

END LOOP; 



Remove for Parent Object instances 
FOR each RelatedDockingObject LOOP 

Run ParameterSQL to get newPrimaryld of RelatedDockingObjects 
FOR each newPrimaryld retrieved LOOP 

Check if the instance of the object is visible to the laDtoD 
user * y 

CheckObjectVisibility (LaptopNodeld, ObjectName, PrimaryRowld) 
IF not visible THEN* 

RemoveOb j ect Ins tance ( LaptopNodeld , 

RelatedDockingObject, newPrimaryRowId) ; 



END IF; 
END LOOP; 
LOOP; 



return TRUE; 

} 
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WHAT IS CLAIMED ft: 

1 . A method of selectively transmitting a transaction from a central database 
to at least one node having a partially replicated database, comprising the steps of: 

(a) encoding the transaction in a docking object representing the transaction 
5 and including at least one table and at least one rule; 

(b) selecting a node; 

(c) executing the rule against the selected node to obtain a result; and 

(d) selectively transmitting the transaction to the selected node depending 
on the result. 

10 

2. The method of claim 1 in which the rule is a Stuctured Query Language 
(SQL) rule. 

3. The method of claim 1 in which the partially replicated database is a 
IS relational database. 

4. The method of claim 1 in which the selected node is intermittently in 
communication with the central database. 

20 5, A method of selectively transmitting a transaction from a central database 

to at least one node having a partially replicated database, comprising the steps of: 

(a) encoding the transaction in a primary docking object, said primary 
docking object representing the transaction and indicative of at least one related 
docking object, said related docking object including at least one table and at least 

25 one rule; 

(b) selecting the related docking object; 

(c) selecting a node; 

(d) executing the rule against the selected node to obtain a result; and 

(e) selectively transmitting the transaction to the selected node depending 
30 on the result. 



The method of claim 5 in which the rule is an SQL rule. 
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7. The method of claim 5 in which the partially replicated database is a 
relational database. 

8. The method of claim 5 in which the selected node is intermittently in 
communication with the central database. 

9. The method of claim 5 in which said related docking object is indicative of 
an additional related docking object and steps (a) through (d) are recursively 
performed for said additional related docking object. 

10. A computer program product for selectively transmitting a transaction from 
a central database to at least one node having a partially replicated database, 
comprising a computer usable medium having machine readable code embodied 
therein for performing the steps of: 

(a) encoding the transaction in a docking object representing the transaction 
and including at least one table and at least one rule; 

(b) selecting a node; 

(c) executing the rule against the selected node to obtain a result; and 

(d) selectively transmitting the transaction to the selected node depending 
on the result. 

11. The computer program product of claim 10 in which the rule is an SQL 
rule. 

12. The computer program product of claim 10 in which the partially replicated 
database is a relational database. 

13. The computer program product of claim 10 in which the selected node is 
intermittently in communication with the central database. 



14. A computer program product for selectively transmitting a transaction from 
a central database to at least one node having a partially replicated database, 
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comprising a computer usable medium having machine readable code embodied 
therein for performing the steps of: 

(a) encoding the transaction in a primary docking object, said primary 
docking object representing the transaction and indicative of at least one related 
docking object, said related docking object including at least one table and at least 
one rule; 

(b) selecting the related docking object; 

(c) selecting a node; 

(d) executing the rule against the selected node to obtain a result; and 

(e) selectively transmitting the transaction to the selected node depending 
on the result. 

15. The computer program product of claim 14 in which the rule is an SQL 
rule. 

16. The computer program product of claim 14 in which the partially replicated 
database is a relational database. 

17. The computer program product of claim 14 in which the selected node is 
intermittently in communication with the central database. 

18. The computer program product of claim 14 in which said related docking 
object is indicative of an additional related docking object and steps (a) through (d) 
are recursively performed for said additional related docking object. 

19. An apparatus for selectively transmitting a transaction from a central 
database to at least one node having a partially replicated database, comprising: 

(a) a processor; and 

(b) a memory in communication with the processor, 
wherein the processor is configured to perform the steps of: 

(i) encoding the transaction in a docking object representing the 
transaction and including at least one table and at least one rule; 
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(ii) selecting a node; 

(iii) executing the rule against the selected node to obtain a result; 

and 

(iv) selectively transmitting the transaction to the selected node 
depending on the result. 

20. The apparatus of claim 19 in which the rule is an SQL rule. 

21. The apparatus of claim 19 in which the partially replicated database is a 
relational database. 

22. The apparatus of claim 19 in which the selected node is intermittently in 
communication with the central database. 

23. An apparatus for selectively transmitting a transaction from a central 
database to at least one node having a partially replicated database, comprising: 

(a) a processor; and 

(b) a memory in communication with the processor, 
wherein the processor is configured to perform the steps of: 

(i) encoding the transaction in a primary docking object, said 
primary docking object representing the transaction and indicative of at least one 
related docking object, said related docking object including at least one table and 
at least one rule; 

(ii) selecting the related docking object; 

(iii) selecting a node; 

(iv) executing the rule against the selected node to obtain a result; 

and 

(v) selectively transmitting the transaction to the selected node 
depending on the result. 



24. The apparatus of claim 23 in which the rule is an SQL rule. 
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25. The apparatus of claim 23 in which the partially replicated database is a 
relational database. 

26. The apparatus of claim 23 in which the selected node is intermittently in 
communication with the central database. 

27. The apparatus of claim 23 in which said related docking object is indicative 
of an additional related docking object and steps (i) through (iv) are recursively 
performed for said additional related docking object. 
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AMENDED CLAIMS rcT/ub97/o4JZ0 
[received by the International Bureau on 05 September 1997 (05.09.97)- 
original claims 1.5,10,14,19 and 23 amended; remaining claims' 

unchanged (4 pages)] 
1 A method ot selectively transmitting a transaction trom a central database to at least 

one node having a partially replicated database, comprising the steps of: 

(a) encoding the transaction in a docking object representing the transaction and 
including at least two tables and at least one rule; 

(b) selecting a node; 

(c) executing the rule against the selected node to obtain a result; and 

(d) selectively transmitting the transaction to the selected node depending on the 

result. 



2. The method of claim 1 in which the rule is a Structured Query Language (SQL) rule. 

3. The method of claim 1 in which the partially replicated database is a relational 
database. 



4. The method of claim 1 in which the selected node is intermittently in communication 
with the central database. 



5 A method of selectively transmitting a transaction from a central database to at least 
10 one node having a partially replicated database, comprising the steps of: 

(a) encoding the transaction in a primary docking object, said primary docking object 
representing the transaction and indicative of at least one related docking object, said related 
docking object including at least two tables and at least one rule; 

(b) selecting the related docking object; 
15 (c) selecting a node; 

(d) executing the rule against the selected node to obtain a result; and 

(e) selectively transmitting the transaction to the selected node depending on the 

result. 

20 6. The method of claim 5 in which the rule is an SQL rule. 



7. The method of claim 5 in which the partially replicated database is a relational 
database. 
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8. The method of claim 5 in which the selected node is intermittently in communication 



with the central database. 

9. The method of claim 5 in which said related docking object is indicative of an 
5 additional related docking object and steps (a) through (d) are recursively performed for said 

additional related docking object. 

10. A computer program product for selectively transmitting a transaction from a central 
database to at least one node having a partially replicated database, comprising a computer 

10 usable medium having machine readable code embodied therein for performing the steps of: 

(a) encoding the transaction in a docking object representing the transaction and 
including at least two tables and at least one rule; 

(b) selecting a node; 

(c) executing the rule against the selected node to obtain a result; and 

15 (d) selectively transmitting the transaction to the selected node depending on the 

result. 

11. The computer program product of claim 10 in which the rule is an SQL rule. 

20 12. The computer program product of claim 10 in which the partially replicated database 
is a relational database. 

13. The computer program product of claim 10 in which the selected node is 
intermittently in communication with the central database. 

25 

14. A computer program product for selectively transmitting a transaction from a central 
database to at least one node having a partially replicated database, comprising a computer 
usable medium having machine readable code embodied therein for performing the steps of: 

(a) encoding the transaction in a primary docking object, said primary docking object 
30 representing the transaction and indicative of at least one related docking object, said related 

docking object including at least two tables and at least one rule; 

(b) selecting the related docking object; 

(c) selecting a node; 

(d) executing the rule against the selected node to obtain a result; and 
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(e) selectively transmitting the transaction to the selected node depending on the 

result. 



15. The computer program product of claim 14 in which the role is an SQL rule. 

16. The computer program product of claim 14 in which the partially replicated database 
is a relational database. 

17. The computer program product of claim 14 in which the selected node is 
intermittently in communication with the central database. 

18. The computer program product of claim 14 in which said related docking object is 
indicative of an additional related docking object and steps (a) through (d) are recursively 
performed for said additional related docking object. 

19. An apparatus for selectively transmitting a transaction from a central database to at 
least one node having a partially replicated database, comprising: 

(a) a processor; and 

(b) a memory in communication with the processor, 
wherein the processor is configured to perform the steps of: 

(i) encoding the transaction in a docking object representing the transaction and 
including at least two tables and at least one rule; 

(ii) selecting a node; 

(iii) executing the rule against the selected node to obtain a result; and 

(iv) selectively transmitting the transaction to the selected node depending on 

the result. 



20. The apparatus of claim 19 in which the rule is an SQL role. 

21. The apparatus of claim 19 in which the partially replicated database is a relational 
database. 



22. The apparatus of claim 19 in which the selected node is intermittently in 
communication with the central database. 



AMENDED SHEET (ARTICLE 19) 



WO 97/35265 36 . PCT/US97/04320 

23. An apparatus for selectively transmitting a transaction from a central database to at 
least one node having a partially replicated database, comprising: 

(a) a processor; and 

(b) a memory in communication with the processor, 

5 wherein the processor is configured to perform the steps of: 

(i) encoding the transaction in a primary docking object, said primary docking 
object representing the transaction and indicative of at least one related docking object, said 
related docking object including at least two tables and at least one rule; 

(ii) selecting the related docking object; 
10 (iii) selecting a node; 

(iv) executing the rule against the selected node to obtain a result; and 

(v) selectively transmitting the transaction to the selected node depending on 

the result. 

15 24. The apparatus of claim 23 in which the rule is an SQL rule. 

25. The apparatus of claim 23 in which the partially replicated database is a relational 
database. 

20 26. The apparatus of claim 23 in which the selected node is intermittently in 
communication with the central database. 

27. The apparatus of claim 23 in which said related docking object is indicative of an 
additional related docking object and steps (i) through (iv) are recursively performed for said 
25 additional related docking object. 
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STATEMENT UNDER ARTICLE 19 

The International Search Report identified only US patent 5,446,885 as being a novelty 
destroying (Category X) document. Only this reference is addressed below: 

US 5,446,885 is specifically directed at single database that may contain a formula/equation 
inside the database. Thus, the formula (rule) is at the database level. This is specifically 
reflected in column 4, lines 45-55: 

"Data and rules will be stored in the GRMS database 102 . The data will be 
stored as a relational database Rules for GRMS will be stored as objects 
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in the database. The term "object" is an abstraction (like a variable in 
mathematics) that represents a value that is returned by an associated retrieval 
program." (Emphasis added) 

The patent disclosure, identified by the ISA, at column 14 lines 25-64, does not change this 
interpretation of the patent. In fact, it does nothing more than discuss simple report 
generating functions for a relational database. 

The claimed invention is in stark contrast. First, US 5,446,885 does not teach the concept 
of a docking object and, in particular, does not teach a docking object representing at least 
two databases. Hence, a docking object is not the same as a database. Instead, it is more 
analogous to a single representation of a series of databases. 

Second, in the claimed invention, the rule is associated with the docking object. This is not 
the same as simply storing the rule in a database. Instead, the rule associated with the 
docking object (of two or more databases) is a criteria that determines whether a particular 
instance of a docking object is "visible" to a particular node. If the docking object is visible 
to a particular node, that node will receive updates for data. (Application as filed, p. 7. lines 
13-15). Nothing remotely approaching this is taught in US 5,446,885. 

Finally, there is no teaching in US 5,446,885 that a rule is executed against a selected node 
to obtain a result that, in turn, dictates whether information is selectively transmitted to the 
node. Thus the rule relates to whether information is updated at a selected node. This is 
quite different from the "rule" or equation stored in database 102 in US 5,446,885. It is also 
different from the usual report generating functions/queries disclosed in column 14, lines 25- 
64 of this patent. These relate to obtaining information from a database not transmitting 
information to a node. 
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